home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / comm / ykh122.zip / YKH.TXT < prev   
Text File  |  1993-04-30  |  9KB  |  231 lines
  1. YKH v1.2.2 Copyright (c)1993 Bryan McNett
  2.  
  3. YKH comes with ABSOLUTELY NO WARRANTY. For details, read GNUGPL.TXT.
  4. This is free software, and you are welcome to redistribute it
  5. under certain conditions. Read the file GNUGPL.TXT for details.
  6.  
  7. Thank you for taking a look at YKH, a freeware Japanese VT320
  8. emulator for DOS! I hope that you find YKH as useful as I have.
  9. I am sorry that YKH does not have many of the features people have
  10. come to expect in terminal software, such as phonebooks or file
  11. transfers. I would like to implement these features, time permitting.
  12. If you have any questions or comments, please feel free to write me
  13. (the author) at the following addresses:
  14.  
  15. internet:      u94_bmcnett@vaxc.stevens-tech.edu
  16. US Mail :      Bryan McNett
  17.                Box S-835
  18.                Castle Point Station
  19.                Hoboken, NJ 07030 USA
  20.  
  21. revision history:
  22.  
  23. Version 1.2.2 properly displays kanji; version 1.2.1 did not. (sorry!)
  24. new command-line options and an .INI file also appear first in this
  25. version.
  26.  
  27. Versions previous to 1.2.1 loaded the entire kanji font into unused
  28. video planes so that no kanji caching mechanism would be necessary.
  29. Well, this turned out to be a dumb idea. As soon as I installed MEMMAKER
  30. on my machine, YKH's kanji began to appear scrambled and broken up.
  31. So I spent a few hours rewriting the kanji display routines, and now they do
  32. use a cache, and do work with MEMMAKER.
  33. ---------------------------------------------------------------------------
  34.  
  35. contents:
  36.  
  37. YKH overview
  38. requirements
  39. how to install YKH
  40. the file YKH.INI
  41. command-line options
  42. dialing your modem from within YKH
  43. how to exit YKH
  44. how to enter kana into YKH
  45. how to switch between EUC and SJIS modes in YKH
  46. how to use YKH with host systems that garble Japanese text
  47. credits
  48.  
  49. ---------------------------------------------------------------------------
  50. YKH overview
  51.  
  52. YKH is a program for DOS that emulates a VT320 terminal while properly
  53. displaying Japanese text. It is able to connect via modem through comports
  54. 1 and 2, or over local-area networks using the DECNET LAT and DECNET CTERM
  55. network terminal protocols. Unlike most Japanese terminals, YKH is able
  56. to fix Japanese text that has been damaged by escape-code stripping.
  57. The terms of YKH's distribution are described in GNUGPL.TXT.
  58.  
  59. ---------
  60. requirements
  61.  
  62. YKH requires at least an 80286 CPU, the extended keyboard BIOS, a VGA
  63. graphics adapter, and about 128K of free RAM.
  64.  
  65. ---------
  66. how to install YKH
  67.  
  68. To install YKH, copy the files YKH.EXE, YKH.INI, and JIS.16 into one of
  69. the directories in your PATH. If the file JIS.16 is absent from the directory
  70. that YKH.EXE is in, YKH will run, but it will not be able to display Japanese
  71. text. Note that YKH runs much faster when not displaying Japanese text.
  72.  
  73. ---------
  74. the file YKH.INI
  75.  
  76. YKH.INI, like the .INI files used by Microsoft Windows applications, contains
  77. information and default values that remain the same between YKH sessions.
  78. When YKH is run, it searches in the current directory for YKH.INI, and
  79. if it cannot find it there, it searches in the directory where YKH.EXE
  80. resides. The structure of the YKH.INI file is as follows:
  81.  
  82. [section]
  83. item=value
  84. item=value
  85. [section]
  86. item=value
  87.  
  88. and here are the various sections and items currently in use by YKH:
  89.  
  90. [Ports]
  91.  
  92. port
  93. the port used to communicate with the host computer. can be com1, com2,
  94. lat, or cterm. lat and cterm are DECNET network terminal interfaces,
  95. and can be used to login to networked systems running DECNET.
  96. defaults to com1.
  97.  
  98. service
  99. the DECNET node name of the system you intend to login to using the lat
  100. or cterm terminal interfaces. generally, a six-letter word.
  101. no default value.
  102.  
  103. [Modem]
  104.  
  105. baudrate
  106. the baudrate at which YKH should communicate with your modem.
  107. generally set to 300,1200,2400,4800, or 9600. defaults to 2400.
  108.  
  109. databits
  110. the number of bits per byte used to hold information. defaults to 8.
  111.  
  112. stopbits
  113. the number of bits per byte used as stop bits. defaults to 1.
  114.  
  115. parity
  116. can be none, even or odd. defaults to none.
  117.  
  118. [Kanji Fonts]
  119.  
  120. font16
  121. full pathname to file containing the shapes of kanji characters. If an
  122. incomplete pathname is specified, the current directory will be
  123. searched, and then the directory where the executable file YKH.EXE
  124. resides will be searched.
  125. YKH's kanji file is in the same format as JIS.16 used by the word processor
  126. NJSTAR, so it is possible to keep one copy of this file on your hard drive
  127. for both YKH and NJSTAR to use. defaults to JIS.16.
  128.  
  129.  
  130. ---------
  131. command-line options
  132.  
  133. Most of the options that you can set in YKH.INI can be overridden if
  134. specified on the command-line. Here is a list of command-line options
  135. used by YKH:
  136.  
  137. (any option may begin with either a - or a / character)
  138.  
  139. -p[1|2|c|l] com port # or network terminal port name (l for lat, c for cterm)
  140. -sXXXXXX    DECNET node name you wish to connect to
  141. -d#         # databits
  142. -P[n|o|e]   none, odd, or even parity
  143. -S#         # stopbits
  144. -b#         baudrate of # bps
  145. -h
  146. -?          list command-line options
  147.  
  148. ---------
  149. dialing your modem from within YKH
  150.  
  151. Once you have run YKH with the correct settings, you must dial your
  152. modem manually with the keyboard. For most modems, this means typing
  153. ATDT, followed by the number you wish to dial, and then hitting the
  154. Enter key. For example, to dial the number 555-1212, you could type
  155. this line:
  156.  
  157. ATDT5551212
  158.  
  159. Consult your modem's manual if this does not work.
  160.  
  161. ---------
  162. how to exit YKH
  163.  
  164. You can exit YKH at any time by pressing Ctrl+F10.
  165.  
  166. ---------
  167. how to enter kana into YKH
  168.  
  169. It is possible to enter kana directly into YKH, even though your keyboard
  170. does not have kana. YKH has three keyboard input modes: roumaji,
  171. hiragana, and katakana, which can be selected with the F5, F6, and F7
  172. keys, respectively. When you are in roumaji mode, your terminal responds
  173. to your keystrokes in much the same way a VT320 would. When you are in
  174. hiragana or katakana mode, everything you type is converted from roumaji
  175. to kana, and then displayed on the top line of the screen. When you are
  176. finished typing a string of kana, hit the Enter key. This will send the
  177. kana string to the host computer in the "new-jis" format, and then
  178. return you to roumaji input mode.
  179. To abort sending the kana string you have just typed, hit the Esc key.
  180. You will be returned to roumaji input mode.
  181. This is a clumsy system that is not very useful. I wrote it into YKH
  182. only so that I could use Jim Breen's "xjdic" program on the workstation in
  183. my office from my dorm room.
  184. A future version of YKH will include kana->kanji lookup, which is
  185. arguably very useful when one is trying to enter Japanese text.
  186.  
  187. ---------
  188. how to switch between EUC and SJIS modes in YKH
  189.  
  190. Most of the Japanese text encountered on computers will be in the New-JIS
  191. or Old-JIS formats, which YKH is able to detect and display correctly in all
  192. circumstances. There are other Japanese text formats, however, that YKH is
  193. unable to distinguish between. The EUC and Shift-JIS formats overlap, so
  194. there is no simple way for YKH to determine if Japanese characters are
  195. in one or the other. For this reason, YKH allows you to choose which format
  196. you'd like to use. Pressing the F8 key switches between EUC mode, in which
  197. EUC and SJIS text is displayed as EUC text, and SJIS mode, in which EUC
  198. and SJIS text is displayed as SJIS text. An indicator at the upper left hand
  199. corner of the screen tells you which mode YKH is currently in.
  200.  
  201. ---------
  202. how to use YKH with host systems that garble Japanese text
  203.  
  204. If you are trying to look at what you have been told is Japanese text,
  205. and it looks something like this instead:
  206.  
  207. $@F|K\8l(J
  208.  
  209. chances are that the system you have connected to is not transmitting
  210. the escape codes that let most Japanese terminals know when to display
  211. Japanese text. "news" and the VMS operating system are common culprits.
  212. YKH provides a simple solution to this problem. Hitting the F4 key toggles
  213. "fix" mode, in which YKH inserts escape codes into garbled Japanese text in
  214. an attempt to display it co